home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GRAPHICS / MPEGWORK.SPK / MPEG-Works / !MPEG / !Help < prev    next >
Text File  |  1996-09-03  |  6KB  |  160 lines
  1.  
  2.  MPEG decoder (03-September-1996)
  3.  ================================
  4.  
  5.  Version 1.08 by Søren Lange and Henrik Bjerregaard Pedersen
  6.  
  7.  This is our port of version 2.0 of the Berkeley MPEG-1 decoder.
  8.  We gratefully acknowledge the work of the Computer Science Division-EECS,
  9.  Univ. of Calif. at Berkeley.
  10.  
  11.  This program is Public Domain, and is provided 'as is'. The authors cannot
  12.  accept any liability for any damage or loss of any kind as a result of the
  13.  use of this program.
  14.  You are allowed to copy, distribute and use this program for any
  15.  non-commercial purposes, as long as this file is included unaltered.
  16.  
  17.  Bug report, suggestions (and donations!!!) to
  18.  
  19.  Søren Lange
  20.  Aldershvilevej 113, 1, -1
  21.  DK-2880 Bagsvaerd
  22.  Denmark
  23.  email: lange@login.dknet.dk
  24.  
  25.  or
  26.  
  27.  Henrik Bjerregaard Pedersen
  28.  Bellahoejvej 126 st. th.
  29.  DK-2720 Vanlose
  30.  Denmark
  31.  email: henrik@login.dknet.dk
  32.  
  33.  
  34.  MPEG filetype
  35.  -------------
  36.  The Acorn allocated filetype for MPEG is &BF8.
  37.  
  38.  
  39.  Using the decoder
  40.  -----------------
  41.  *MPEGDecode [-leave] [-at <x> <y>] [-memory <address>] [<format>]
  42.              <mpegfile> [<directory>]
  43.  
  44.  
  45.  (ie.  *MPEGDecode <mpegfile>                       to display the file
  46.  
  47.   or   *MPEGDecode <mpegfile> <directory>           to save the frames as PBM
  48.  
  49.   or   *MPEGDecode sprite16 <mpegfile> <directory>  to save the frames as
  50.                                                     16bpp new format sprites
  51.  
  52.   or   *MPEGDecode -at 0 0 <mpegfile>               to display the movie in
  53.                                                     the bottom left corner of
  54.                                                     the screen
  55.  
  56.   or   *MPEGDecode -leave <mpegfile>                to display the movie and
  57.                                                     leave the last frame on
  58.                                                     screen
  59.  
  60.   or   *MPEGDecode -leave -at 0 0 <mpegfile>        to display the movie in
  61.                                                     the bottom left corner and
  62.                                                     leave the last frame on
  63.                                                     screen
  64.   or   *MPEGDecode -memory <address> <mpegfile>     to output to a block in
  65.                                                     memory)
  66.  
  67.  
  68.  When saving the frames:
  69.  
  70.  Possible formats are
  71.  PBM (default), sprite, sprite16, sprite24, greysprite, P15, Replay.
  72.  
  73.  The directory will be created if it doesn't already exist. Frame number N
  74.  is stored as '<directory>.<N DIV4096>.<(N DIV64)MOD64>.<N MOD64>'.
  75.  Eg. frame number 67 will be saved as '<directory>.0.1.3'.
  76.  
  77.  
  78.  When displaying the frames:
  79.  
  80.  Pressing MENU will abort the playback; pressing ADJUST will pause the film.
  81.  
  82.  
  83.  Output to memory:
  84.  
  85.  The '-memory' switch forces MPEGDecode to write the data to an area in
  86. the memory. This can be in the RMA or in a dynamic area; MPEGDecode doesn't
  87. care and simply crashes if you call it with an illegal address!
  88.  You should not uses this switch!!!!
  89.  
  90.  
  91.  History
  92.  -------
  93.  08-Jan-1995
  94.  1.01:  - B-frames are output in the correct order.
  95.         - 'Done!' is no longer displayed at the end.
  96.         - The frames may be displayed (in 4, 8, 16 or 32 bpp modes).
  97.  
  98.  14-Jan-1995
  99.  1.02:  - Commandline arguments cleaned up.
  100.         - 50-75% faster display.
  101.         - 50% faster saving.
  102.         - 5-7% faster decoding (overall typically 15-20% faster than 1.01).
  103.         - File operations done using DeskLib rather than CLib.
  104.         - Correct positioning of frames on-screen in non-square pixel modes.
  105.  
  106.  26-Jan-1995
  107.  1.03:  - Reading is done using CLib, writing still uses DeskLib.
  108.         - Adobted the sprites from Paul LeBeaus !MPEG.
  109.  
  110.  10-Feb-1995
  111.  1.04:  - Can output in several different formats.
  112.         - Fixed small bug preventing some large movies to be displayed in
  113.           rectangular pixel modes.
  114.         - Screen is redrawn when exiting. Notice: This requires that !MPEG
  115.           isn't stored in a write-protected directory. It is all done in a
  116.           rather messy way. Sorry.
  117.         - Improved malloc() check.
  118.  
  119.  18-Apr-1995
  120.  1.05:  - Improved redrawing when exiting. It is no longer required that
  121.           the decoder is stored in a non-write-protected directory.
  122.         - Correct frame height. Used to be a multiple of 16 pixels always.
  123.         - New output format - Replay; this saves the frames in an uncompressed
  124.           format 2 Replay movie. If the decoding is aborted prematurely, the
  125.           file will be left open.
  126.         - New output format - P15; this is a 15bpp version of PBM.
  127.         - Much faster saving of 'greysprite' and 'sprite24'.
  128.         - The filetype is set when a frame is saved.
  129.  
  130.  11-May-1995
  131.  1.06:  - The movie can be displayed at any point on the screen.
  132.         - Redrawing when the movie ends can be prevented.
  133.         - Playback control can be done using the mouse buttons.
  134.         - The colour lookup-tables are now specified in the !Run and !Boot
  135.           files. You can replace them with '<ARMovie$Dir>.MovingLine.4rgb11c01'
  136.           and '<ARMovie$Dir>.MovingLine.8rgb11'.
  137.         - Output to memory.
  138.  
  139.  04-Jun-1995
  140.  1.07:  - 'helpful' sprite included in the ARMovies generated by specifying
  141.           'Replay' as output format.
  142.  
  143.  03-Sep-1996
  144.  1.08:  - Save as Replay used to crash some machines (due to DeskLib???).
  145.           Hopefully it works better now.
  146.         - Never runs faster than 25 frames/second! Not likely to be a problem
  147.           on A5000s, but on a StrongARM machines it may be possible for small
  148.           movies.
  149.  
  150.  * IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
  151.  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
  152.  * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
  153.  * CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  154.  *
  155.  * THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  156.  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  157.  * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  158.  * ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
  159.  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  160.